'\" te
.\"  Copyright 1989 AT&T  Copyright (c) 1997 Sun Microsystems, Inc.  All Rights Reserved.
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
.TH YPMATCH 1 "Aug 22, 1997"
.SH NAME
ypmatch \- print the value of one or more keys from a NIS map
.SH SYNOPSIS
.LP
.nf
\fBypmatch\fR [\fB-k\fR] [\fB-t\fR] [\fB-d\fR \fIdomain\fR] \fIkey\fR [\fIkey\fR]... \fImname\fR
.fi

.LP
.nf
\fBypmatch\fR \fB-x\fR
.fi

.SH DESCRIPTION
.sp
.LP
\fBypmatch\fR prints the values associated with one or more keys from the
\fBNIS's\fR name services map specified by \fImname\fR, which may be either a
map name or a map nickname.
.sp
.LP
Multiple keys can be specified; all keys will be searched for in the same map.
The keys must be the same case and length. No pattern matching is available. If
a key is not matched, a diagnostic message is produced.
.SH OPTIONS
.sp
.LP
The following options are supported:
.sp
.ne 2
.na
\fB\fB-k\fR\fR
.ad
.RS 13n
Before printing the value of a key, print the key itself, followed by a colon
(\fB:\fR).
.RE

.sp
.ne 2
.na
\fB\fB-t\fR\fR
.ad
.RS 13n
Inhibit map nickname translation.
.RE

.sp
.ne 2
.na
\fB\fB-d\fR\fI domain\fR\fR
.ad
.RS 13n
Specify a domain other than the default domain.
.RE

.sp
.ne 2
.na
\fB\fB-x\fR\fR
.ad
.RS 13n
Display the map nickname table. This lists the nicknames the command knows of,
and indicates the map name associated with each nickname.
.RE

.SH OPERANDS
.sp
.LP
The following operand is supported:
.sp
.ne 2
.na
\fB\fImname\fR\fR
.ad
.RS 9n
The \fBNIS's\fR name services map
.RE

.SH EXIT STATUS
.sp
.LP
The following exit values are returned:
.sp
.ne 2
.na
\fB\fB0\fR\fR
.ad
.RS 5n
Successful operation.
.RE

.sp
.ne 2
.na
\fB\fB1\fR\fR
.ad
.RS 5n
An error occurred.
.RE

.SH SEE ALSO
.sp
.LP
.BR ypcat (1),
.BR ypfiles (5),
.BR attributes (7)
.SH NOTES
.sp
.LP
\fBypmatch\fR will fail with an \fBRPC\fR error message on yp operation if
enough file descriptors are not available. The number of file descriptors
should be increased if this occurs.
